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4. INTRODUCTION 


AGENDA FILES is a very useful and versatile personal or 
small business memo system which does not presuppose any great 
familiarity with computers on the part of the user. Lo as 
designed to aid you in organizing your agenda for the coming days 
and weeks, or in other words, to aid you in keeping track of 
things to be done. The program provides you with six files, 
which are named and numbered: 


The File for Today 

The File for Tomorrow 

The File for the Day after Tomorrow 
The File for the Future 

The First List 

The Second List 


ANN LSwWwhy = 


The last two files (which can be renamed) are 
general-purpose files with various uses (see Section 14}. The 
contents of the first four files will normally consist of notices 
of appointments, reminders, tasks, etc., such as _ 'Pay phone 
bill', ‘Collect tickets’, "Begin service for client 219', and so 
on. The proper contents of these four files change from day to 
day, since today's Tomorrow file will tomorrow become the Today 
file and so on. The required updating (based on the current 
date} is done automatically each time the program is run. 


You may: 


(i) Enter items into any position in any of these six 
files. 


(ii) Delete items. 
(iii) Transfer items from any file to any other file. 


(iv) Print any item in a file or the entire contents of 
any file. 


(v) Search files for items containing a specified 
keyword. 


(vi) Re-order the contents of any file. 
When entering an item into the Future file, you may request 
that a notice be given in advance of the date associated with 


this item. These and other features of this program will be 
explained in detail below. 
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AGENDA FILES provides most of the features which could be 
asked of such a program (subject to the 48K memory limitation of 


the Apple J{ Plus). For example, a calendar function is 
provided, so that whenever a date has to be entered, the calendar 
may be consulted if you are unsure about the date. When 


reviewing the contents of a file you may decide that a certain 
item should be postponed to a later date, in which case you can 
transfer that item to another file by means of a simple command; 
no need to delete that item and then re-enter it in the new 
file. No longer do you have suffer the usual splitting of words 
at the end of a line on the monitor screen. AGENDA FILES has 
many such convenient features, and the more you use it the more 
you will come to appreciate them. 


Whenever the program asks you a question which requires a 
Yes or No answer, you may respond simply by entering a Y or an 
N. Sometimes when the program asks you a question you will see a 
flashing letter or number on the screen. This means”7 that 


pressing RETURN will have the same effect as entering that 
character. 


In this documentation, to ‘enter' a character or character 
string means to type that character or string and then press the 
RETURN key. An item typed at the keyboard is not ‘entered' until 
RETURN is pressed. At any time before you press RETURN you’ may 
use the backspace key to correct any typing errors. During the 
execution of this program, almost all inputs require you to press 


RETURN at the end. This allows you to have second thoughts about 
an entry. 


To use AGENDA FILES simply boot the disk. (This is done by 
inserting the AGENDA FILES disk, closing the door’ to the disk 
drive, and switching on your Apple.) In addition to the main 
AGENDA FILES program there is a quick-entry program on the disk. 
When you boot the disk for the first time, the main program will 
automatically be run. Subsequently, when you boot the disk you 
will be asked whether you require the full program or the 
quick-entry program. Until you are familiar with the use of 
AGENDA FILES it is better to choose the full program. (See 
Section 17 for more on the quick-entry program.) 


2. PRINTER PARAMETERS 


AGENDA FILES is useful even without a printer, but for full 
utilization of its capabilities a printer is recommended. When 
the program is run for the first time it will ask you which slot 
the printer is in (conventionally slot 1). If there is no 
printer installed then enter '@' (zero) here. If you specify a 
slot geo it then the program will ask you for the printer width, 


that the numbcr of columns to be used by the printer (49 
eeecuk *4 32, often 89). 
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The program stores this information, and displays it at’ the 
beginning of each run. If you wish to install a printer (after 
running AGENDA FILES without one), to change the printer slot or 
the printer width, or to remove the printer, then the program 
provides you with the opportunity to do this at the beginning of 
each run. You may use the program without a printer connected 
even if you have told it that a printer is connected, but in this 
case if you ask the program to print something then it will 

hang'. | 


3. ENTERING THE CURRENT DATE 


Each time (after the first) the program is run it will 
display the date of the last run and will ask you for’ today's 
date. Apart from the requirement that the month precede the day, 
AGENDA FILES does not require that you enter the date in a fixed 
format (such as MM/DD/YY). Enter the date in your usual way, as 
in '12/1/81' (for ‘December ist, 1981'). (It should be 
remembered, both by programmers and users of programs, that 
humans do not have to conform to the supposed requirements of 
computers. Rather, computers can be made, with some effort, to 


conform to human needs’ and practices, as this program 
demonstrates. ) | 


You must use some character to separate the numerals, but it 
need not be the slash sign. If you prefer you may enter dates in 
the form '12.1.81' or ‘'12-1-81'. You can even change the 
Separator sign each time that you run the program, if you wish, 
by using the new sign when entering the current date. 


When entering the current date, at the start of the program, 
you must specify the year. Subsequently you can simply enter the 
month and the day, as in '12/31' (December 31st), and the program 
will add the appropriate year. For example, if the current date 
is 9/15/81 (September 15th, 1981), and you enter a date as '3/15' 
(March 15th), the program will interpret this as 3/15/82 (since 
the date 3/15/81 belongs to the past, relative to the current 
date, and is thus inappropriate). 


AGENDA FILES also allows you to specify the current date by 
entering the number of days’ since the last run. Thus if the 
program was last run on January 4th, and the current date is 
January 7th, then you may simply enter '3'. If you last ran the 
program yesterday then enter ‘'1', If you have already run the 
program today then enter '@' (or simply press RETURN). 


Once you have specified the current date in either of these 
ways, the program will display the day and date, and ask you to 
verify that this is correct. (At this point you encounter your 
first flashing letter, a flashing Y. Pressing RETURN here is 
equivalent to answering Yes to the question.) This is to ensure 
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that you are in fact entering today's date correctly. Once the 
date has finally been entered the program loads the files from 
disk and may rearrange the items’ in them. If the program was 
last run yesterday, then what yesterday was the Tomorrow file now 
becomes the Today file, and so on. Furthermore, any items in the 
Future file which (with regard to today's date) now belong in one 
of the first three files are automatically transferred to the 
proper file. 


If you notice (after the program has loaded the files from 
disk) that you have incorrectly entered today's date (e.g. 
"6/1/91" instead of '6/1/81') all is not lost. Simply turn off 
the power and then reboot the disk. 


4. REVIEW OF PAST ITEMS 


The program incorporates an automatic review of 'past' 
items. Suppose that on January ist you have several items in the 
Today file and the Tomorrow file, and that you next run. the 
program on January 4th (or some later date). What happens to 
those items for January Ist and 2nd? Some of them may still be 
pending (since one can't do everything in one day), so before 
checking for any advance notices (see below) the program will 
allow you to review any items left over from the past. This 
allows you to check to see whether there were some things to do 
which were left undone - in which case these items can be saved 
by transferring them to one of the current files (see Section 9 
on Consulting a File). 


It is often useful to have a_ record cf things done, and so 
AGENDA FILES allows you to. print this Past file after 
transferring or deleting any items which were not carried out. 
When you instruct the program to check for any advance notices it 
will first (if a printer is installed) ask you if you want’ these 
items from the past printed. (At this point you have the option 
of looking through the file again, by entering F.) If you do not 
instruct the program to print these items, they are deleted. 


When reviewing past items, as when consulting a file, your 
alternative entries are displayed on the upper half of the 
screen. When consulting a file, the final alternative is always 
to return to the List of Options (see Section 6). When reviewing 
past items, the final alternative may instead be to check for 
advance notices. Which it is depends on whether there is an item 
in your files with an advance notice request associated with it. 
If not then the program skips the advance notice check. 
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5. ADVANCE NOTICE 


The advance notice capability of AGENDA FILES will be found 
especially useful by anyone who has to meet deadlines, appear 
often in court, attend meetings, file reports on time, etc. If 
you have payments to meet then a notice a few days in advance is 
often useful. 


When entering an item into any file other than the Today 
file and either of the two Lists you may request a notice in 
advance of, or on, the date associated with this item. You can 
specify any number of days' advance notice up to about three 
months. When the program is run on subsequent days, if the 
current date coincides with, or is later than, the date on which 
the advance notice is due then the program will remind a of 
this item by displaying it (after the review of past items). 


As each advance notice is given, the program will ask you if 


you wish to remove or change the advance notice request. By 
removing it you can avoid subsequent unwanted reminders. 


The advance notices are given only once each day the program 
is run. In other words, each day that the program is run any 
advance notices are given on the first run, at which point you 
have the option of printing them; in subsequent runs on the’ same 
day the advance notices are skipped. 


When you enter an item into a file and the program asks you 
if you wish a notice in advance then you can simply press RETURN 
if you don't. If you wish to have a special reminder on the date 
associated with this item then enter '@' (zero) in response to 
this question. (In the case of entries into the Tomorrow file, 
the program will ask you if you want a special reminder 
tomorrow. ) The program will not accept any request for an 
advance notice whose due date is the same as, or earlier than, 
the current date. 


6. THE LIST OF OPTIONS 


After receiving any advance notices you move on to the main 
part of the program and are presented with the List of Options. 
There are eight options (or nine, if re-initialization is 
displayed as an option), and (at this point) there are 46 
admissible entries (47 including the re-initialization command). 
(If, here or elsewhere, you enter something inadmissible, the 
Apple will beep and allow you to re-enter.) The admissible 
entries are: 
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The numerals designate the six files (see Section 1). With 
regard to each of these files there =re six options: 
F Consult (or view the contents of) a file. 
P Print the contents of a file, or the first three files 
together, or all or part of the contents of the 
Future file. 


O Re-order the contents of a file, 

S Search a file, or the first four files together. 

E Enter new items into a file. 

K Clear (or empty) a file. 

If you enter F, P, O, S, E or K alone then the program will 
ask you which file (or files) this instruction applies to. This 
procedure can be shortened by entering one of these characters in 
combination with a numeral, as_ above. For example, Pe means 


'Print out the contents of the Tomorrow file', E4 means ‘Enter 
new items into the Future file', and S5 means ‘Search through The 
First bist? '; The meaning of the print and the_- search 
instructions P*® and S* will be explained later. Enter C_ to 
consult the calendar. To save your files on disk, enter D. To 
re-initialize, enter *, For a fuller explanation of these 
options see the sections below. 


7. CALENDAR 


AGENDA FILES has ae built-in calendar for January 1991 
through December 1999. At many points in the program (e.g. when 
entering items into the Future file) you may consult the calendar 
by entering C. The program will then ask you which month you are 
interested in. If the current date has already been entered, and 
you wish to see the current month, then you can simply press 
RETURN. Otherwise specify the month in the form '12/81' (for 
December 1981). 


If the current month is being displayed, the current day 
Will be shown in inverse. If the calendar is being consulted 
when transferring or entering items into the Future file, or when 
printing the Future file, then all days prior to the first date 
of the Future file will be shown in inverse. In other words, 
only those days will be shown normally which correspond to dates 
permitted to items in the Future file. 
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8. ENTERING NEW ITEMS 


This section deals with entering items using the full AGENDA 
FILES program. See Section 17 below for an explanation of the 
use of the quick-entry program. 


On the first run, since there are no items in the files, the 
E instruction is the only one (other than C and D) that you can 
use. To enter new items into file n, enter En when the List of 
Options is displayed. The names and numbers of the files, 
together with the number of items in each file (and the total 
number of items in the six files), are displayed on tne screen 
below the List of Options. 


Each item can consist of up to 20% characters (five lines on 
the monitor screen). In any case the Apple will not accept 
character strings longer than 255 characters. Ee Sone Cre ree 
enter such a character string then the Apple will beep when you 
approach the limit, and if you go over 255 characters then you 
will have to re-enter the item. 


The amount of memory in the Apple J[ Plus available for the 
contents of the files is limited (see below), and longer items 
means fewer can be stored. If the program is being used in an 
application requiring more than 19@ items in the files then the 


items should generally be kept to less than 89 characters (two 
lines on the screen). 


You may use all keyboard characters in an item, including 
commas and colons. If an item is entered with leading spaces 
then these will be eliminated. If you must have spaces at the 
beginning of an item then, when entering the item, press S while 
holding down the CTRL key, before typing the spaces, 


To enter items (after entering En at the List of Options) 
type each item and press RETURN, The computer then requests any 
further information which is required, such as_ the date 
associated with the item. After entry, the item is then 
re-displayed together with any date and any advance notice. If 
you. have requested n days' advance notice then '[A.N.: nJ' will 
appear before the item. '[A.N.: @]' means a special notice on 
the date of the item. When you have entered all the items that 
you wish to enter then press RETURN or enter’ R and you will be 
returned to the List of Options. 


When entering items into any of the first three files, there 
is no need to specify the date (since the program already knows 
the dates associated with these three files). When entering 
items into the Future file the program will ask you, after each 
item is entered, for the date (if any) associated with this 
item. (Do not enter the date until you are asked for it.) You 
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may enter the date fully, in the form '12/31/81', or you’ may 
Simply enter the day and month in the form '12/31' (for December 
31st), as explained in Section 3. 


It is not necessary to enter a date when you enter an item 
into the Future file. You may wish to record something to be 
done in the future without wishing to specify a date. In this 
case press RETURN when the program asks you for the date. (See 
the “ahah olay section for providing a formerly undated item with 
a date. 


When you enter an item into the file for The Day after 
Tomorrow, or into the Future file together with a date, the 
program will ask you how many days' advance notice you require 
(if any). In the case of dated entries into the Future file, any 
number of days' advance notice up to three months may be 
specified. In the case of entries into the file for The Day 
after Tomorrow only '@' (meaning notice on date) and '‘'1' are 
admissible. (For further details see Section 5.) 


When you enter an item into the Future file, and you specify 
a date, that item will automatically be placed in its correct 
chronological position in the Future file. Undated items are 
placed at the end of the Future file, unless the '>n:' prefix is 
used (see below). Thus when consulting the Future file you will 
always find that the items are ordered chronologically. 


It may happen that you wish to place an item in a_ certain 
position ina file. Suppose that you wish to place the item CALL 
LOLA in the fifth position in the Tomorrow file. To do this, 
enter E2 at the List of options, then enter >5:CALL LOLA. This 
is all that is needed. Generally speaking, if you wish to place 
an item in the nth position in the file then, when entering that 
item, prefix it with '>n:'. (A space thrown in here or there 
will not matter, but the '>' and the ‘':'! are both required.) 
Usually there is no need to use the 'Dn:' prefix. Without the 
prefix, items are placed at the end of the file (except in the 
case of items entered into the Future file with a date). So if 
you wish you can ignore the possible use of the '>n:' prefix, 
using the Re-order option (see Section 11) when you need to 
change the position of an item in a file. 


If you instruct the program to place anitem in the nth 
position in the file then it will heed this command only if n is 
an appropriate number. For example, you cannot place an item in 
the 5th position if there are only three items in the file, and 
you cannot place an undated item among the dated items in the 
Future file (any undated items are always located after the dated 
items in the Future file). 


After DOS is booted and AGENDA FILES is loaded there will be 
enough space in memory for about 265 4@-character lines of text. 
Although each of the six files can hold up to 5@ items, there is 
not enough memory in an Apple J[ Plus with 48K for 300 (6 x 58) 
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multi-line items. Insofar as there is space in memory for about 
189 (6 x 30) items each of 1 1/2 lines (6@ characters - an 
average length in personal applications), it is unlikely that the 
memory limits will be encountered in ordinary personal use. 


When you use the E option the program will inform you of how 
many lines of text the Apple still has space for in memory. 
Whenever there is space for less than about ten lines, you will 
encounter a notice warning you that the memory limit of the 
computer is at hand, that it is inadvisable to enter any further 
items, and that it is advisable to delete some. The program will 
allow you to continue to consult files, etc., but if the Memory 
Limit warning is displayed three times then the program will 
automatically store the files on disk. 


When there are many items in the files you will notice that 
occasionally the Apple pauses briefly at unpredictable places. 
What is happening here is that the computer is doing a little 
internal house-cleaning (eliminating unwanted character strings 
from memory). When this occurs, wait until the cursor reappears 
before pressing any keys. 


9. CONSULTING A FILE 


If at the List of Options you enter Fn (where n is any 
numeral from 1 through 6) the program will take you to the 
designated file. When consulting a file, the screen is divided 
into two halves: The upper half lists your options at this 
point; the lower half consists mainly of an item from the file 
you are consulting. You will observe two numerals in the lower 
left-hand corner of the screen, thus: 3/8. The righthand 
numeral shows the number of items in the file, and the lefthand 
numeral shows the position in the file of the item displayed (so 
"3/8" means 'this is the third item of eight'). 


The admissible entries are listed on the screen as follows: 


for Next item 
for Last (i.e. previous) item 
to Delete this item 
to Print this item 
# to Transfer this item 
to consult Calendar 
to Return to the List of Options 


wo 4S vOo rs 


You may move back and forward within a file by entering N or 
L. When an item is displayed there will be a flashing N in the 
lower right-hand corner of the screen. This means that pressing 
RETURN will cause the next item in the file to be displayed. 
Thus you can move quickly through a file by holding down the 
RETURN and the REPT keys simultaneously. When you reach the end 
of the file you will encounter an end-of-file message anda 
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flashing R (or sometimes, not always, in the case of the review 
of past items, a flashing A). Pressing RETURN here will return 
you to the List of Options (or send the computer to check for any 
advance notices). 


It may happen that you wish to go directly to the last 
(tl V6 final) item in a file (since items entered without the 
">n:' prefix and without a date are placed at the end of the 
file). This can be done as follows: Upon display of the first 
item in the file, enter L (which gives you a_ beginning-of-file 
message) and then L again. This will take you to the last item 
in the file. Similarly, when you come to the end of the file, 
entering N twice will bring you again to the first item in the 
file. 


If the Future file contains both dated and undated items, 
then on display of the first item in the Future file (a dated 
item) you can go directly to the first undated item in the file 
by entering U. 


When an item is displayed on the screen, you can do three 
things with it: delete it, print it or transfer it to another 
file. In the first two cases enter D or P. To transfer the item 
to file n, enter Tn. Here, just as when entering commands at the 
List of Options, you can enter T alone, in which case the program 
Wiil ask you which file you wish to transfer the item to. If you 
transfer an item to the Future file (by entering T4) then you 
Will be asked for the date, etc., just as if you were entering a 
new item into the Future file. 


When transferring an item to another file you cannot (as you 
can when entering items) specify the desired position of the item 
in the new file. If you wish to change the position of an item 
in a file then the Re-order option can be used. 


If you wish to retain the item in its present file but to 
change the advance notice request or (in the case of the Future 
file) to change the date (or adda date to a hitherto undated 
item), then (when that item is displayed) enter T with the number 
of the present file, in effect removing the item from the file 
and re-entering it. The program will then ask you about the date 
(if the Future file) and the advance notice, and you can make any 
desired changes. 


Most of this information is displayed on the top half of the 
screen when you are consulting a file. Although it is advisable 
to study this documentation before using AGENDA FILES, so as to 
be informed of what it can do, the program is designed to be used 
without the need for continual reference to the documentation. 
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40. PRINTING A FILE 


To print a file, enter Pn at the List of Options, where n is 
the number of the file. When printing a file the program prints 
out the contents of that file with the appropriate heading (which 
includes today's date). 


If you wish to print the contents of the first three files 
then enter P®, This will provide you with an overview of the 
things to be done during the next three days. 


On entering P4 (to print the Future file) you will find that 
there are four print options available. You may print: 


(i) the whole contents of the future file, 

(ii) only the dated items, 

(iii) only items up to (and including) a certain date, or 
(iv) only items between two dates (inclusive). 


If you chose option (iii) or option (iv) then the date may 
be entered fully ('12/31/81') or in abbreviated form ('12/31'), 
as explained above. The program will check your date entries so 
as to exclude any which are inappropriate. 


Any print routine in this program may be terminated during 
execution by pressing T. If T is pressed during a print routine 
then the printing will be terminated a few seconds later, when 
the printer has finished printing the current item. 


44. RE-ORDERING A FILE 


It is often desirable to re-order the items in a file (e.g., 
so that the things to be done first appear first in the print-out 
of the file). The procedure for re-ordering a file is as follows 
(here it is assumed that a printer is connected, though 
re-ordering can be done without one): 


To re-order the items in, for example, the Today file, first 
enter @1: ‘at. the List. of . Options. Beside each item in the 
print-out of the file write the desired position of that item in 
the file. For example: 


BEGIN SERVICE FOR CLIENT 216 2 
PAY PHONE BILL 4 
RESUME WORK ON DOCUMENTATION 1 
5 
3 


DINNER WITH LIZ 
LUNCH WITH JONES 


MNEwhry 
e e e @ 


Now (you are back at the List of Options) enter 01 
(alphabetical '0O'). The program will then display each item in 
the file and ask you for its desired position. In this example 
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You would enter in turn *2*, *8*, *1*, *S* ond °3'.° The items in 
the file will then be found to be in the desired order. 


If, in re-ordering a file, you try to place two items in the 
same position you will be informed of your oversight. If you 
quit halfway through the re-ordering procedure by entering Q then 
the items whose positions you have specified will be found in 
those positions, and the remaining items in file will be located 
among them in possibly new positions (none will be lost). 


When re-ordering a file you may skip an item by pressing 
RETURN, This is useful when re-ordering a file containing many 
items, for when writing out the desired positions on the first 
print-out of the file you may not’ be able to specify a position 
for every item. In such a case, specify positions for aS many 
items as you can, skip the other items when re-ordering, get a 
new print-out, and repeat this process until the items are 
ordered to your satisfaction. 


Only the undated items in the Future file can be 
re-ordered. When you enter O4 to re-order the Future file the 
program will skip over the dated items, permitting you to change 
only the order of the undated items. If there is only one item 
in a file, or if there is only one undated item in the Future 


file, then the program will disregard a re-order request for that 
file. 


12. CLEARING A FILE 


To clear a file, by entering Kn, is to delete all of the 
items in that file. When you instruct the program to clear a 
file’ 10. will ask ‘if you. are sure. If you are then you’ can 
respond with KETURN. If you have second thoughts then enter NO 
(or N) and the file will remain intact. 


If you wish to clear all the files and start anew, the 
re-initialization option can be used (see Section 16). 


43. THE SEARCH OPTION 


When uSing the search option, you specify a ‘keyword’ of up 
to 9 characters, and the p®Wogram searches for items containing 
that keyword. The instruction Sn causes’ the program to search 
through file n. The instruction S* produces a search’ through 
files 1-4, that is, through all files except the two Lists. 


You may enter any string of characters as the keyword, but 
for the purpose of the search that string is truncated to. the 
first nine characters. Thus a search under’ the keyword BEGIN 
SERVICE might return the following items: 
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BEGIN SERVICE FOR JONES 
TODAY BEGIN SERVICE FOR #219 
BEGIN SERUM ANALYSIS 

BEGIN SERMON 


(Spaces are characters also.) 


There are two search modes available: full search and 
initial search. After you have entered the keyword, the program 
will ask which search mode is to be employed. In full search, 
the program will return any item which contains’ the keyword 
anywhere within it. In initial search, the program will return 
any item containing the keyword at the beginning (as its initial 
character string). In the example above, searching in initial 
mode would return the 1st, 3rd and 4th items, but not the 2nd. 


The reason for having these two search modes is’ that an 
initial search is often much faster than a full search. For 
example, suppose there are about forty items in files 1-4, 
totalling about sixty lines of text (24@® characters). Then an 
item with a 9-character keyword as its initial character string 
will be recovered by a full search through files 1-4 in at most 


thirty seconds, but by an initial search in at most five 
seconds. 


If you have many items in the files and you know that’ the 
keyword occurs at the beginning of the item you wish to search 
for, then use the initial search mode; otherwise use the full 
search mode. Pressing RETURN when the program asks about the 
search mode will produce a full search. 


In some applications the following remark may be relevant: 
The items in the files can be 'pre-sorted' by prefixing each item 
(or some items) with a control character. (Control-A is obtained 
by pressing A while holding down the CTRL key, and similarly for 
the other letters.) Suppose that in files 1-4 some items are 
prefixed with control-A, some with control-B, etc. Then all 
items in these files prefixed with, say, control-B, may be 
recovered quickly by entering S*® at the List of Options and then 
using control-B as the keyword in an initial search. (It should 
be remembered that any control character in an item or a keyword 


will not be visible when that item or keyword is displayed on the 
screen.) 


If the search routine finds one or more items containing the 
specified,, keyword then the program will ask you if you wish to 
have these items printed. Thus if you have a dozen items under 
the same keyword then they probably will not all fit on the 
screen but they can be recovered on a printer. At most fifty 


items (the maximum capacity of each file) can be recovered by 
search. 


You can terminate the search at any time by pressing T. 
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Thus if the item you are looking for has appeared on the’ screen, 
you can terminate the search without having to wait for the 
program to search through the rest of the items in the file. 


44. THE TWO LISTS 


The Lists are simply lists; there is no date associated with 
any item in a List (unless a date is included in the item 
itself). The Lists are general-purpose files, and can be used in 
a variety of ways. Some examples of their possible uses follow: 


(i) Long-term projects, things (perhaps of a certain kind) 
to be done sometime. These could also be entered into the 
Future file as undated items, but if there are many of them 
they may clutter up the file and interfere with your’ review 
of other things to be done in the future. 


(ii) Shopping list. When you remember something you need to 
buy, enter it (possibly using the quick-entry program), then 
take with you a printed list when you go shopping. 


(iii) List of phone numbers (and/or addresses). The search 
option is useful with this application. Enter your’ phone 
numbers, e.g.: 


MARY, 345-8990 
MAUDE (415) 833-9229 
JACK, 983 3387 


Then to find a phone number’ simply use an initial search 
with the person's name as keyword. Alternatively, searching 
with a phone number as keyword will return the person's name 
(but note that '833-8220' is a different character string 
from '833 0220"). 


(iv) A list of steps to be taken in carrying out a certain 
project. From time to time this list can be reviewed, and 
steps may be deleted or added; it can then be re-ordered and 
printed for reference. 


During the development of this program one of the Lists was 
used for just this purpose, to list further steps required in the 
development of the program. 


You may stipulate your own headings for the two Lists, and 
change them at will. Whenever you enter items into a List the 
program will ask you if you are content with the current list 
heading (as displayed). If not, you may change it to anything 
you like (up to 12@ characters). Provided that you save your 
files on disk (see the following section) your new list heading 
will be retained on subsequent runs. Clearing a List file does 
not erase any heading you may have stipulated for that file (but 
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re-initialization does). 


If you wish to change a List heading without changing the 
contents of the file then enter E5 (or E6) at the List of 
Options, enter the new heading, then press RETURN when the 
program asks you to enter new items. If you prefer not to have 
any list heading at all in print-outs then press RETURN when the 
program asks you for the new list heading. 


At the beginning of the program the first four files are 
loaded from disk into the Apple's memory, but the files for’ the 
two Lists are not. If and when a List file is required it is 
loaded from disk. 


15. SAVING FILES AND TERMINATING PROGRAM EXECUTION 


When you enter items into your files they exist only in the 
Apple's memory until you enter D at the List of Options to save 
the files on disk. You need only do this once, just’ before 
terminating program execution (though the files may be saved on 
disk at any time, and more than once). If you have not’ entered, 
deleted or transferred any item, and the contents of the files 
have not been changed in any other way (such as by entering a new 
date), then there is no need to save your files on disk (since 
they are already there). Whenever you need to save your files, 
this is shown by the presence of a pointer at the left of the D 
in the List of Options. Before terminating program execution, 
always check to see whether the pointer is displayed, in which 
case enter D to save your files on disk. 


After you have finished working with AGENDA FILES simply 
turn the power off. The List of Options contains no option to 
exit the program, and the RESET key does not work as usual, so 
the only way out of the program (and the simplest way out) is to 
turn the power off. No items in your files will be lost by doing 
this, provided that (if necessary) you have saved your files on 
disk. 


Do not save other programs or files on your AGENDA FILES 
disk. If you do then you’ risk encountering a Disk Full error 
when the program is attempting to store your files. If no other 
programs or files are stored on your AGENDA FILES disk then there 
is no danger of this happening. 


46. RE-INITIALIZATION 


This option will rarely (if ever) be employed. It is there 
in case you wish to begin anew entirely (as will be the case if 
you first experiment with the program for a while, then 
re-initialize and begin to use it in day-to-day practice). 
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Re-initialization wipes out all the items in the files. Thus if 
you enter '*' at the List of Options to re-initialize then the 
program will ask you for confirmation. Since the 
re-initialization option is normally not used, it disappears from 
the List of Options after it has been displayed a few times. 


17. QUICK ENTRY 


It may sometimes happen, while you are reading or engaged in 
some other pastime, that you think of something which should be 
entered into your files. If you don't wish to do anything except 
enter one or more items, the quick-entry program can be used to 
accomplish the task quickly, providing that the following two 
conditions hold: (1) The program has already been run today (or 
in other words, the date of the last run is the same as’ today's 
date). (2) You don't wish to enter a dated item into the Future 
file (undated items are OK). Using the quick-entry program, .an 


item can be entered in less than thirty seconds from the moment 
you boot the disk. 


After the first run, when you boot the AGENDA FILES disk you 
will be asked whether you require the quick-entry program or the 


full program. The conditions for the use of the quick-entry 
program are displayed on the screen at this point to help you 
decide. If you choose the full program then it will be loaded 
and run. 


If you choose the quick-entry program (by pressing Q) then, 
to enter items, first choose the number of the file (the names 
and numbers of the files are displayed on the screen at this 
point) then enter the item. If you press the wrong key when 
selecting the file, press RETURN and try again. You may enter up 
to twenty items using the quick-entry program. When there are no 
further items to be entered, press @ (zero) and the program will 
add your new items directly to the files on disk. You can then 
enter further items if you wish, or go on to the full program. 
Otherwise, terminate program execution by switching off the 
power. 


If you choose the quick-entry option, then decide you want 
the full program, press @ and the full program will be loaded and 
run. 


48. FILE FIX 


At the end of each run, AGENDA FILES stores on the disk not 
only the items in your files but also information which it will 
need on the next run, such as’ the number of items in the files. 
If something interferes with this storage it is unlikely that 
your files could be successfully loaded from disk on re-running 
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the program. An act of folly such as opening the door to the 
disk drive (or pressing RESET) while the program is saving the 
files on disk, or a Disk Full error caused by storing other 
programs on the AGENDA FILES disk, would be required to produce 
such an event. Just in case something like this does happen, a 
remedy is provided in the form of the program on the disk called 
FILE FIX. If either the QUICK ENTRY or the AGENDA FILES program 
encounters an irregularity in the files on disk then FILE FIX 
will automaticaly be run. This program inspects’ the files. on 
disk, extracts (if possible) the information required by the 
AGENDA FILES program, then runs that program. Ordinarily FILE 
FIX will never be used, but if the message "Now Fixing Files" 
ever appears on the screen, it will be FILE FIX at work. 


49. CONCLUDING REMARKS 


Before settling down to use this program in day-to-day 
practice it is useful to experiment with it for a while in order 
to find out what you can do with it. After reading this 
documentation, enter various imaginary items, and move them 
around between files, checking to see that they go where you have 
told them to go. Run the program a few times with different 
dates to see what happens to the items in the files. Try out the 
re-order and the search options. Check that the items in the 
Future file are in fact arranged in chronological order after 
each new entry, and so on. When you are ready to use AGENDA 
FILES in day-to-day practice, run the program and re-initialize 
by entering '*' at the List of Options. 


Often in the execution of AGENDA FILES the next’ step is 
accomplished simply by pressing RETURN, When experimenting, 
press KETURN often in response to queries, and see what happens. 


One feature of AGENDA FILES which may not be evident at 
first sight is that it is completely neutral as to the nature of 
the items you choose to place in the files. The program requires 
only that they be (or be represented by) strings of not more than 
20@ characters entered at the Apple's keyboard. AGENDA FILES was 
designed as a personal memo system, but it could also be used for 
other purposes. Do you, in your work, have to do certain things 
on certain days, those things being known some time in advance? 
If so then, when you learn of things to be done, you can enter 
them into the files -provided by this program, with their dates 
(if further away than the day after tomorrow), and you can then 
forget about them (for awhile). Providing you run the program at 
least once each day, you will always have a list at hand of those 
things to be done today, or tomorrow, or the day after tomorrow, 
or all three, or in the future, or between any two dates in the 
future =- the items in this. list being ordered either 


chronologically oor according to your wish. You can browse 
through the files, rearranging the items in them at will, adding, 
deleting and moving them around. Furthermore, you can recover 
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any item (or perhaps a set of items) if you know at least one 
word (or more generally, one character string) in it (or them), 
by uSing the search option, and then you can print it (or them). 
All this is without regard to what it or them may be, in other 
words, without regard to what you put in your files. 


If you have many things to do each day then you will find 
AGENDA FILES to be an almost indispensible aid, consulted first 
with your morning coffee and thereafter several times during the 
day. we hope that as you work with this program, its many 
user-oriented features will make it continually more enjoyable to 
use, 
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APPENDIX A 


SETTING UP THE APPLE Il SYSTEM 


This appendix includes a list of the equipment you'll need to use 
AGENDA FILES on your Apple II. You do not need to read all the 
manuals, but they should be on hand to answer questions that may 
arise in operating the equipment (e.g., how to boot a diskette). 


AGENDA FILES is written in Applesoft BASIC. To use it you'll 
need: 


Oo an Apple II Plus with 48K bytes RAM; or 


Oo an Apple II with 48K bytes RAM and an Applesoft BASIC 
Firmware Card; or 


o an Apple II with the Apple Language System. 


© a Video Monitor or Television; 
Oo One or More Apple Disk II's (One with Controller and 
16-Sector Proms); 
For reference, you should have on hand a_ copy of the following 
manuals: 


© This Manual (A User's Guide to the Programs); 


Oo an Apple II BASIC Programming Manual (Setting up the 
Apple II); 


o a DOS Manual (HOw to Boot the Diskettes). 
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PUTTING THE PIECES TOGETHER 


Here are the steps to follow to put your system together: 


(1) To set up your Apple II, follow the instructions in the Apple 
II BASIC Programming Manual. You may not need to attach the 
Game Controllers, although there is no harm in doing so. 
Your Apple II must have at least the minimum amount of 
inmemory listed under the equipment description for you to use 
the programs. 


(2) If you already have a Disk Operating System, and are using a 
version of DOS that runs in13 sectors (DOS 3.2.1 or 
earlier), you will need to change two proms’) on your disk 
controller card to update your system to 16 sectors. Any 
version of DOS earlier than release 3.3 will need to be 
updated. These proms are also the same proms that come with 
the Pascal Language System. Consult a DOS 3.3 manual for 
these procedures. 
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APPENDIX B 
NOTES ON COPY PROTECTION 


Special Delivery Software is copy protected, except in the case 
of program utilities or template-applications for major products 
(e.g. Apple PILOT). 


In Order to provide you with a backup capability, we enclose 
a second diskette. You should definitely store your backup in a 
safe location, and NOT use it. In the event your main diskette 
becomes damaged within the time period of Special Delivery 
Software's media warranty, you may return the main diskette to us 
for replacement, and continue to use your backup until we can 
send you a replacement. 


Unlike most other copy protection schemes, our method is 
selective; protected and unprotected files may reside on the same 
disk. On this diskette, all program files are protected, but the 
text files you create are not. If you boot from DOS 3.3, you 
will be able to catalog this diskette. FID will enable you to 
transfer unprotected files between this diskette and other disks 
in either direction, provided of course, that there is sufficient 
space on the destination disk and it is not write-protected. In 
short, the unprotected files are normal DOS files with all the 
properties thereof. On the other hand, the protected files can 
only be run by booting from the disk on which they reside. Any 
attempt to copy, load, run, or verify them from normal DOS will 
result in an I/O ERROR. No damage is done; the fact is’ merely 
that normal DOS cannot access these files. 


Memory protection is also in effect. If an unauthorized 
form of access is detected, the memory protection procedure will 
zero out all memory. Once triggered, your screen will be filled 
with R's (or Q's) ona white background. You will have to 
re-power your system to re-start any new application. 
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Dear Customer: 


IMPORTANT: SPECIAL DELIVERY SOFTWARE 
products purchased from APPLE or authorized 
APPLE dealers are provided to you subject to 

the Terms and Conditions of this Software License 
Agreement. Should you decide that you cannot 
accept these Terms and Conditions, then you 
must return the product to the point of purchase, 
with all documentation and with this License, 
marked “REFUSED; within the 7-day examination 
period following receipt of the product. 


1. License. APPLE grants to you, upon receipt 

of the product, a nonexclusive license to use the 
enciosed SPECIAL DELIVERY SOFTWARE product, 
subject to the terms and restrictions set forth 

in this License Agreement. 


2. Copyright. SPECIAL DELIVERY SOFTWARE, 
including its documentation, is copyrighted by 
APPLE or, in some cases, by APPLE’s software 
suppliers. You may not copy or otherwise reproduce 
the SPECIAL DELIVERY SOFTWARE or any part of 
it, except as expressly permitted in this License. 
Any SPECIAL DELIVERY SOFTWARE product that 
is not copy-protected may be copied for back-up 
use only, provided that you reproduce all copyright 
notices and other proprietary legends on such 
copies. 


3. Restrictions on Use and Transfer. The original 
and any back-up copies of SPECIAL DELIVERY 
SOFTWARE are intended for your personal use in 
connection with a single computer. You may not 
distribute copies of, or any part of, SPECIAL 
DELIVERY SOFTWARE to others without the 
specific granting of a Software Distribution License 
from APPLE for that purpose. 


4. Media Warranty. To the original purchaser only, 
APPLE warrants the diskettes on which SPECIAL 
DELIVERY SOFTWARE is recorded to be free from 
defects in materials and faulty workmanship under 
normal use for a period of 90 days after the date 


SPECIAL DELIVERY 


SOFTWARE ™ 


CUSTOMER LICENSE 


AGREEMENT 


of purchase. If, during this 90-day period, a defect 
in the diskette should occur, the diskette and a copy 
of your receipt may be returned to the SPECIAL 
DELIVERY SOFTWARE Operation at APPLE, and 
APPLE will replace the diskette without charge. 
Following the 90-day period, and for as long as 
the product remains in the SPECIAL DELIVERY 
SOFTWARE catalog, APPLE will replace defective 
diskettes for a fee of $15. Your sole remedy in 

the event of a defect in the diskette is limited to 

the replacement of the diskette as provided above. 


5. LIMITATIONS ON WARRANTY AND LIABILITY. 
EXCEPT AS EXPRESSLY PROVIDED FOR MEDIA, 
APPLE AND ITS SOFTWARE SUPPLIERS, 
DISTRIBUTORS, AND DEALERS MAKE NO 
WARRANTIES, EITHER EXPRESSED OR IMPLIED, 
WITH RESPECT TO THE SPECIAL DELIVERY 
SOFTWARE, ITS MERCHANTABILITY, OR ITS 
FITNESS FOR ANY PURPOSE. SPECIAL 
DELIVERY SOFTWARE IS LICENSED SOLELY ON 
AN “AS IS” BASIS. THE ENTIRE RISK AS TO 

ITS QUALITY AND PERFORMANCE IS WITH YOU. 
SHOULD THE SPECIAL DELIVERY SOFTWARE 
PROVE DEFECTIVE, YOU (AND NOT APPLE OR 
ITS SUPPLIERS, DISTRIBUTORS, OR DEALERS) 
ASSUME THE ENTIRE COST OF ALL NECESSARY 
SERVICING, REPAIR, OR CORRECTION, AND 
ANY INCIDENTAL OR CONSEQUENTIAL 
DAMAGES. IN NO EVENT WILL APPLE OR ITS 
SUPPLIERS, DISTRIBUTORS, OR DEALERS BE 
LIABLE FOR DIRECT, INDIRECT, INCIDENTAL, OR 
CONSEQUENTIAL DAMAGES RESULTING FROM 
ANY DEFECT IN THE SOFTWARE, EVEN IF THEY 
HAVE BEEN ADVISED OF THE POSSIBILITY OF 
SUCH DAMAGE. SOME STATES DO NOT ALLOW 
THE EXCLUSION OR LIMITATION OF IMPLIED 
WARRANTIES OR LIABILITY FOR INCIDENTAL 
OR CONSEQUENTIAL DAMAGES, SO THE ABOVE 
LIMITATIONS MAY NOT APPLY TO YOU. 


SPECIAL DELIVERY SOFTWARE ™ 
10260 Bandley Drive 
Cupertino, CA 95014 


